home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / MUSIUSIC / PCORGAN.LZH / VMUSIC.EXE / README.3 < prev    next >
Text File  |  1989-03-23  |  11KB  |  248 lines
  1. Instructions for VMUSIC.  Page 1   (revision dated February, 1989)
  2. --------------------------------
  3.  
  4. The VMUSIC.COM program, written for the IBM PC and compatibles by 
  5.  
  6.          Ted Holden             phone (703) 760-9713
  7.          1947 Storm Dr.
  8.          Falls Church, Va. 22043
  9.  
  10.  
  11.  
  12. provides most of the features of the PLAY command in BASIC, as 
  13. well as the additional feature of playing two or three 
  14. concurrent voices.  BASIC cannot play more than one voice at a 
  15. time.  The current release of VMUSIC cannot play just a single 
  16. voice, but plays two or three voices.  It produces a more 
  17. complex and bell-like sound than BASIC plays. 
  18.  
  19.           
  20.  
  21.  
  22. - - - - - - - - - - - - - - - - 
  23. |                             |
  24. |    INVOKING THE PROGRAM     |
  25. |                             |
  26. - - - - - - - - - - - - - - - - 
  27.  
  28. Starting at the DOS prompt, enter: 
  29.  
  30.          VM1088 <song file name> <tempo value> <pitch factor>
  31.  
  32. where the parameters are discussed in the file README10.88 .
  33.  
  34. If you expect to use the program repeatedly on one computer, you 
  35. will save time (after determining the tempo and pitch 
  36. parameters) by creating a single-line batch file, for example, 
  37.  
  38.          VMU.BAT
  39.  
  40. to pass those parameters automatically.  An example of the 
  41. contents is:
  42.  
  43.          VM1088 %1 15 1
  44.  
  45.  
  46.  
  47. - - - - - - - - - - - - - - - - 
  48. |                             |
  49. |   PREPARING THE DATA FILE   |
  50. |                             |
  51. - - - - - - - - - - - - - - - - 
  52.  
  53. The data file must be ready when you invoke the program.  The 
  54. following comments and instructions pertain to preparing such a 
  55. data file. 
  56.  
  57. Instructions for VMUSIC.  Page 2   (revision dated February, 1989) 
  58. --------------------------------
  59.  
  60. Each voice begins with a voice designator, followed by a string 
  61. of pitch and duration values.  Such a data string can end within 
  62. one line, or "wrap around" to multiple lines, depending on the 
  63. length of the piece.  If there are to be multiple voices, begin 
  64. each new string with the new voice designator, and the data for 
  65. that voice. 
  66.  
  67. The voices are to be named V1, V2, and V3, but the ordering is 
  68. discretionary: any voice can occupy the first position in the 
  69. file, and (either of) the remaining voice(s) can occupy the next 
  70. position.  The following notes are in two voices for the first 
  71. part of GREENSLEEVES; even though they are presented here in 
  72. capital letters, lower-case letters would be acceptable also. 
  73. The letter Os stand for octave, and the Ls define the standard 
  74. time value. 
  75.      
  76. V2 O3 L8 <D D4 E F. G16 F >C4 C C4 C D4 <A B-4  B- A4. (this can 
  77. extend to more than one line)
  78. V1 O4 L8  D F4 G A. B16 A  G4 E C. D16 E F4  D D C+ D  E4  (this 
  79. can extend to more than one line) 
  80.       
  81. VMUSIC uses mostly the same instruction set as the PLAY command.  
  82. However, there are the following differences:
  83.  
  84.      1.  VMUSIC plays two or three voices concurrently, so there 
  85.          is a command for defining each voice.  
  86.          
  87.          A Voice command is required for VMUSIC, but treated as 
  88.          an "ILLEGAL FUNCTION CALL" in BASIC. 
  89.  
  90.      2.  The T command in BASIC PLAY, representing tempo, is not 
  91.          acceptable for VMUSIC, but a similar function is served 
  92.          by setting the rate for the piece, just after invoking 
  93.          the program.  The T parameter in BASIC can be varied 
  94.          during a piece, while the VMUSIC rate stays unchanged.  
  95.          (The L parameter can be redefined in either BASIC or 
  96.          VMUSIC.  This is covered below.)
  97.  
  98.      3.  The MB and MF commands in BASIC (for Music Background 
  99.          and Music Foreground) have no relevance in this program, 
  100.          because all the music is in the foreground, and 
  101.          currently, no resources (meaning, computer registers) are 
  102.          available for background tasks.  
  103.  
  104.      4.  The use of variables, which is acceptable for the PLAY 
  105.          statement in BASIC, does not work in VMUSIC.  For 
  106.          example, the following sequence is legal in BASIC but not 
  107.          in VMUSIC: 
  108.               
  109.                  OCTV% = 3.5 - RND
  110.                  PLAY (O=OCTV% A B C)
  111.  
  112. Instructions for VMUSIC.  Page 3   (revision dated February, 1989)
  113. --------------------------------
  114.  
  115.      5.  The BASIC default values for octave and length of note 
  116.          are not consistently maintained in VMUSIC, so the user 
  117.          should specify those numbers explicitly, before any notes. 
  118.  
  119.  
  120. OCTAVES  The PC can play a range of seven octaves, numbered from 
  121.          zero (the lowest) to six.  Middle C is in octave three.  
  122.          For this discussion, an octave starts at C and continues 
  123.          to the B above it.  By default, failing to designate an 
  124.          octave, selects octave four.  To specify a starting 
  125.          octave or a change in octaves, the syntax is the letter 
  126.          O, followed by a digit 0 to 6, such as  "O4" (without the 
  127.          quotation marks.  In this guide, quotation marks are used 
  128.          to delimit a string, but the actual datafile for VMUSIC 
  129.          should NOT contain any quotation marks.  In BASIC, it is 
  130.          proper to use quotation marks in some cases.) 
  131.         
  132.          For VMUSIC and for releases of ADVANCED BASIC starting 
  133.          with 2.0, changes to higher and lower octaves can be 
  134.          indicated with angle brackets as an alternative to the 
  135.          absolute notation of an octave.  The greater-than symbol 
  136.          means one octave higher, and the less-than symbol means 
  137.          one octave lower.  So "O4 C > E D < < F " will play a C 
  138.          in octave 4, followed by an E and a D in octave 5, 
  139.          followed by an F in octave 3.  
  140.          
  141. TONES    The usual letter identifiers apply: a C is a C.  To  
  142.          sharp a note, put a plus-sign or a pound sign ( + or # ) 
  143.          directly after it.  To a flat a note, place a a minus 
  144.          sign ( - ) after it.  Do not use a "b" to flat a note, 
  145.          because that character represents a separate B note.  So, 
  146.          here is an example of a four-note sequence that crosses 
  147.          the boundary from octave four to octave three:  "O4 C+C 
  148.          O3 BB-" to play C_sharp and C in octave 4, followed by B 
  149.          and B_flat in octave 3. 
  150.  
  151. PAUSE    The letter P denotes a pause or rest, a silence that 
  152.          lasts as long as any sounded note in the same context.  
  153.          Use the same duration syntax for P as for any of the 
  154.          actual notes ( C, C+, D, D#, E, ... B ). 
  155.  
  156. DURATION There are at least three ways to designate duration of a 
  157.          note.  If none of them is specified, the effective length 
  158.          of a note is a quarter note.  In the following 
  159.          discussion, this is designated the "automatic default."
  160.  
  161.          Method
  162.          i.      Appended denominator.  When a 1- or 2-digit 
  163.                  number immediately follows a note-letter 
  164.                  (including P), that number is to be treated as a 
  165.  
  166. Instructions for VMUSIC.  Page 4   (revision dated February, 1989)
  167. --------------------------------
  168.  
  169.                  denominator.  For example, "A+1" is the tone 
  170.                  A_sharp for a whole note; "A-16" is the tone 
  171.                  A_flat for a sixteenth note, and "A18" is the 
  172.                  tone A played as an eighteenth note. 
  173.  
  174.          ii.     The current default.  This default is one that 
  175.                  the user establishes.  If there is one set, it 
  176.                  supersedes the "automatic default".  It is the 
  177.                  length of play for any note of unspecified 
  178.                  duration.  
  179.                  
  180.                  The user can replace a previous default with a 
  181.                  different one.  
  182.                  
  183.                  The same "appended denominator" concept from the 
  184.                  method above applies here, too, but instead of 
  185.                  appending a denominator-number to a note, this 
  186.                  method appends a denominator-number to the letter 
  187.                  L.  So, "L8" specifies that henceforth in this 
  188.                  piece, or until a redefinition, notes of 
  189.                  unspecified duration will be played as eighth 
  190.                  notes. 
  191.  
  192.          iii.    Dotted notes.  Dotting produces the same effect 
  193.                  as with conventional music notation:  it 
  194.                  increases by 50% the duration of the note (or 
  195.                  pause) to which it is appended.  Use the period 
  196.                  character ( . ) as the dot.
  197.                     
  198.                  If two or more dots are in sequence, their 
  199.                  effects are cumulative:  each in its turn 
  200.                  increases the aggregate time value to its left 
  201.                  by 50%.  So, if no_dots equals 100%, then 
  202.                  one_dot equals 150%, and two_dots equals 225%.   
  203.                    
  204.                  For example, if default or specified duration is 
  205.                  a quarter note, then in the string "C# B. A-.. " 
  206.                  C_sharp is a quarter note, B is a three-eighths 
  207.                  note, and A_flat plays for a duration of 
  208.                  9/16ths.  
  209.                        
  210. VOICE    This command has no counterpart among BASIC PLAY 
  211.          parameters.  Specify it at the beginning of a voice of 
  212.          music, for example "V2".  For readability, and for 
  213.          compatibility with possible future enhancements, place 
  214.          any "V" in the leftmost column of its line. 
  215.          
  216.          If you want to temporarily block the playing of one voice 
  217.          present in the file, move the lines for that voice to a 
  218.          position in the file past the EOF marker (ASCII 26, 
  219.          represented as a right-pointing arrow).  This method 
  220.  
  221. Instructions for VMUSIC.  Page 5   (revision dated February, 1989) 
  222. --------------------------------
  223.  
  224.          assumes that your word-processor allows you to do this.  
  225.          It also assumes that there are three voices, from which 
  226.          you can disable one.  If there are just two voices, 
  227.          disabling one leaves one voice, which the current version 
  228.          of the program will not play by itself. 
  229.  
  230.  
  231.  
  232.  
  233. --------------------------------
  234.  
  235.  
  236.  
  237. These instructions for VMUSIC were written (10/87) and revised 
  238. (2/89) by
  239.  
  240.          Mark Laster             (301) 267-9384
  241.          240-B Hilltop Lane
  242.          Annapolis, MD   21403
  243.  
  244. For more detail about the PLAY command in BASIC, consult a 
  245. thorough textbook, such as HANDBOOK OF BASIC FOR THE IBM PC, by 
  246. David L. Schneider. 
  247.  
  248.